@useparagon/connect 3.1.0 → 3.2.0-experimental.1

package/dist/src/ConnectInstallFlowClient.d.ts

@@ -0,0 +1,21 @@
+import type ConnectSDK from './ConnectSDK';
+import { CompleteSetupParams, InstallFlowClient, InstallFlowIntegrationConfig, OAuthHandlers, OAuthStartParams, SaveCredentialParams, UninstallParams } from './install-flow/InstallFlowClient';
+/**
+ * SDK-side InstallFlowClient: delegates every operation to the host
+ * ConnectSDK's existing methods, so the SDK's install flow keeps its exact
+ * historical behavior while InstallFlow itself stays consumer-agnostic.
+ *
+ * The headless-mode gate lives in getIntegrationConfig — the first read
+ * InstallFlow performs at start() — so a non-headless SDK surfaces
+ * HeadlessModeNotEnabledError through the flow's normal onError path.
+ */
+export declare class ConnectInstallFlowClient implements InstallFlowClient {
+    private readonly sdk;
+    constructor(sdk: ConnectSDK);
+    getIntegrationConfig(name: string): InstallFlowIntegrationConfig;
+    getAssetUrl(name: string): string;
+    startOAuth(params: OAuthStartParams, handlers: OAuthHandlers): void;
+    saveCredential({ integrationId, payload, installOptions }: SaveCredentialParams): Promise<import("./types").IntegrationInstallEvent | undefined>;
+    completeSetup({ integrationId, credentialId, payload, installOptions }: CompleteSetupParams): Promise<import("./types").IntegrationInstallEvent | undefined>;
+    uninstall({ integrationName, credentialId }: UninstallParams): Promise<void>;
+}

package/dist/src/ConnectSDK.d.ts

@@ -4,11 +4,13 @@ import { OauthCallbackResponse } from './entities/credential.interface';
 import { IConnectIntegrationWithCredentialInfo, IntegrationMetadata } from './entities/integration.interface';
 import { PersonaMeta } from './entities/persona.interface';
 import { ExternalFilePicker } from './file-picker/types';
+import { InstallFlow } from './install-flow/InstallFlow';
 import SDKEventEmitter from './SDKEventEmitter';
 import { ConnectSdkEnvironments } from './server.types';
-import { AccountType, AuthenticateOptions, AuthenticatedConnectUser, CompleteInstallOptions, ConditionalSource, ConnectInputValue, Props as ConnectModalProps, ConnectParams, ConnectUser, CreateConfigurationOptions, CredentialConfigOptions, CustomDropdownField, DataType, DeleteConfigurationOptions, DisableWorkflowOptions, DynamicDataSource, DynamicDefaultInput, DynamicFieldMappingLoaderType, DynamicFieldMappingOptionsResult, EnumInputValue, EnumSection, EventInfo, GetIntegrationAccountOptions, GetTriggerTypesResponse, IConnectSDK, InputSources, InstallFlowStage, InstallIntegrationOptions, InstallOptions, IntegrationConfig, IntegrationConnectInput, IntegrationInstallEvent, IntentInputKeyConfig, KeyedSource, LoadCustomDropdownOptionsResult, ProxyRequestOptions, SerializedConnectInput, SetDataSourcesConfig, SingleSource, StartOptions, TriggerWorkflowRequest, UninstallOptions, UpdateConfigurationOptions, UpdateWorkflowStateResponse, UserProvidedIntegrationConfig } from './types';
+import { AccountType, AuthenticateOptions, AuthenticatedConnectUser, CompleteInstallOptions, ConditionalSource, ConnectInputValue, Props as ConnectModalProps, ConnectParams, ConnectUser, CreateConfigurationOptions, CredentialConfigOptions, CustomDropdownField, DataType, DeleteConfigurationOptions, DisableWorkflowOptions, DynamicDataSource, DynamicDefaultInput, DynamicFieldMappingLoaderType, DynamicFieldMappingOptionsResult, EnumInputValue, EnumSection, EventInfo, GetIntegrationAccountOptions, GetTriggerTypesResponse, IConnectSDK, InputSources, InstallIntegrationOptions, InstallOptions, IntegrationConfig, IntegrationInstallEvent, IntentInputKeyConfig, KeyedSource, LoadCustomDropdownOptionsResult, ProxyRequestOptions, SerializedConnectInput, SetDataSourcesConfig, SingleSource, TriggerWorkflowRequest, UninstallOptions, UpdateConfigurationOptions, UpdateWorkflowStateResponse, UserProvidedIntegrationConfig } from './types';
 export declare const PARAGON_OVERFLOW_EMPTY_VALUE = "PARAGON_OVERFLOW_EMPTY_VALUE";
 export { ExternalFilePicker };
+export { InstallFlow };
 export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
     private sdkVersion;
     root: HTMLIFrameElement | undefined;
@@ -452,8 +454,8 @@ export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
      */
     getSourcesForActionInput(input: IntentInputKeyConfig): SingleSource | ConditionalSource | null;
     getAccountTypeOptions(integrationName: string): AccountType[];
-    getPreOptions(integrationName: string, accountTypeId?: string): IntegrationConnectInput[];
-    getPostOptions(integrationName: string): IntegrationConnectInput[];
+    getPreOptions(integrationName: string, accountTypeId?: string): import("./types").IntegrationConnectInput[];
+    getPostOptions(integrationName: string): import("./types").IntegrationConnectInput[];
     /**
      * fetch dynamic field mapping options (object types or integration fields)
      */
@@ -463,42 +465,3 @@ export default class ConnectSDK extends SDKEventEmitter implements IConnectSDK {
         search?: string;
     }): Promise<DynamicFieldMappingOptionsResult>;
 }
-export declare class InstallFlow {
-    private readonly paragon;
-    private startOptions;
-    private integrationName;
-    private accountTypeValue;
-    private preOptionsValue;
-    private postOptionsValue;
-    private credentialId;
-    private hasFinishedInstruction;
-    private oauthAbortController;
-    constructor(paragon: ConnectSDK);
-    start(integrationName: string, startOptions?: StartOptions): void;
-    cancel(): Promise<void>;
-    private getInstallOptions;
-    private asyncStart;
-    private handleError;
-    private handleNext;
-    private handleComplete;
-    private getScheme;
-    private getIntegrationName;
-    private getSelectedAccountTypeOption;
-    private requiresAccountType;
-    private getIntegrationInstructionMetadata;
-    private getSalesforceInstructionMetadata;
-    private requiresInstruction;
-    private requiresPreOptions;
-    private requiresPostOptions;
-    private requiresOAuth;
-    /** Starts an OAuth authentication flow through a window Pop-up */
-    private handleOAuth;
-    setAccountType(accountType: string): Promise<void>;
-    setPreOptions(options: Record<string, ConnectInputValue>): Promise<void>;
-    setPostOptions(options: Record<string, ConnectInputValue>): Promise<void>;
-    private setHasFinishedInstruction;
-    getAccountTypeValue(): string | null;
-    getPreOptionsValue(): Record<string, ConnectInputValue> | null;
-    getPostOptionsValue(): Record<string, ConnectInputValue> | null;
-    next(): InstallFlowStage;
-}